home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 41 / Amiga Format CD41 (1999-06)(Future Publishing)(GB)[!][issue 1999-07].iso / -seriously_amiga- / programming / other / gui4cli / docs / changes < prev    next >
Text File  |  1999-04-29  |  8KB  |  203 lines
  1.  
  2.   ================================================================
  3.   === VERSION 3.7 CHANGES ------------------------------------->>>
  4.   ================================================================
  5.  
  6.  New Events :
  7.  
  8. - xHOTKEY  KeyCombination  ON|OFF
  9.   Gui4Cli now installs a Commodities Exchange Broker through which
  10.   you can define various HotKeys. The KeyCombination can be something
  11.   like "rawkey lshift f2" (see guide) and it "happens" when the user
  12.   inputs this combination from whereever (i.e. even if a non - Gui4Cli
  13.   window is the active one). You can give it a GADID and SETGAD it 
  14.   ON|OFF, and you can also UPDATE it, giving a new KeyCombination.
  15.  
  16. - xNOTIFY  File|Directory  ON|OFF
  17.   Will set notification on a file or directory and will "happen"
  18.   every time the given file/dir changes in some way (i.e. if it
  19.   is written to or deleted or whatever). You can give it a GADID
  20.   and SETGAD it ON|OFF and you can also UPDATE it, giving a new
  21.   file/dir name.
  22.  
  23.  New Commands :
  24.  
  25. - SPEAK TextString
  26.   Will use the "translator.library" (LIBS:) and the "narrator.device" 
  27.   (DEVS:), both of which you must have, to speak the given text. The
  28.   speaking is done synchronously - i.e. Gui4Cli will stop and wait 
  29.   for the speaking to finish before proceeding.
  30.  
  31. - SET SPEAK Rate/Pitch/Sex/Mode/Volume/Freq
  32.   Will change the voice used in speaking to the new values you give.
  33.   See guide for their meaning. The default is: 150/110/0/0/64/22200
  34.  
  35. - SETSCREENTITLE GuiName Text
  36.   Will set the text that will be shown in the screen's title bar, 
  37.   whenever the given Gui's window is the active one.
  38.  
  39. - FLASH - Will flash the screen - use it to indicate an error.
  40.  
  41. - MOVESCREEN GuiName/#ScreenName X Y
  42.   Will move the screen that GuiName is (or will) open on to position
  43.   X, Y. You can also give the ScreenName directly, by putting # in front.
  44.  
  45. - WORKBENCH OPEN|CLOSE - will open or close the Workbench
  46.  
  47. - SETATTR GuiName/GadID ATRIBUTE VALUE - will set the attributes of the 
  48.   given gadget. Does the same as the ATTR gadget modifier, but dynamically.
  49.   Ex: SetAttr Mygui.gc/1 LVLINEDIST 3 - note that you would have to
  50.   redraw the listview for the change to be visible. 
  51.   (This command was supposedly available in last version, but was not)
  52.  
  53.  Sound support :
  54.  
  55.   Standard mono IFF Samples, up to 64k in length, can now be loaded and 
  56.   used as sound effects or reminders. The commands that handle them, 
  57.   are similar to the image handling commands :
  58.  
  59. - LOADSOUND FileName Alias  - will load the sample and name it "Alias"
  60. - FREESOUND Alias           - will free the above sample
  61. - PLAYSOUND Alias           - will play the sound once
  62.  
  63. - SETSOUND  Alias VOLUME/SPEED value 
  64.   Will set the VOLUME (1-64) or the SPEED (124-1000) ie the pitch.
  65.  
  66.   Sounds can be used as effects on all types of gadgets, and on other
  67.   events like window open/close, RMB and xOnKey. There are 2 ways you 
  68.   can do this.
  69.  
  70.   1.- You can define the sound effects globally, and these will be
  71.       used in all guis:
  72.  
  73.       > SET SndOpen|SndClose|SndGad|SndRMB|SndKey Alias
  74.       
  75.       You can set all these from the Gui4Cli.gc gui (called from
  76.       the main requester in the WB tools menu)
  77.  
  78.   2.- Or, you can define a different sound for every gadget, or key
  79.       or window etc, using the Attribute system, with:
  80.  
  81.       > SETATTR mygui.gc/1 SOUND mysound <or> ATTR SOUND mysound
  82.  
  83.   The sound will be played every time the event is triggered.
  84.   An attribute, if defined, will take precedence over a global sound.
  85.   Note that with ATTR, sounds can also be attached to xONOPEN, xONCLOSE, 
  86.   xRMB and xONKEY events.
  87.  
  88.   TextIn hook :
  89.  
  90.   Added a TextIn gadget hook, providing the following :
  91.  
  92.   xTextIn Gadget Attributes (for ATTR & SETATTR):
  93.  
  94. - TITYPE  INT/FLOAT/HEX/DATE/UPPER/LOWER/STRING
  95.   Will let you define what kind of data can be entered in the 
  96.   gadget. <Attr TiType FLOAT> for example will only let you
  97.   enter numbers and '.' into it. DATE will allow numbers and /.- 
  98.   STRING allows anything. (*** still needs work on formating ***)
  99.  
  100. - TITRANS ON|OFF
  101.   The text in the textin gadget will, by default, be translated
  102.   as soon as you've finished entering data. Set this attribute to
  103.   OFF to stop translation.
  104.  
  105.   xTextIn Internal variables :
  106.  
  107.   $$TI.POS    - the cursor position in the current textin gadget
  108.   $$TI.LENGTH - total length of string in the gadget
  109.   $$TI.REC    - the string in the gadget
  110.   $$TI.ID     - the ID of the gadget
  111.   $$TI.GUI    - the name of the gui it's in
  112.  
  113.   Internal variables :
  114.  
  115. - $$LV.VAR internal variable - will give you the (full path of) the 
  116.   name of the listview variable. eg: mygui.gc/myvar
  117.  
  118. - $$RAND.xxx - will supply you with a random number from 0 to "xxx".
  119.   eg: $$Rand.100 - will give you a random number from 0 to 100.
  120.   Note that if you want a range of 1-100, you would have to do
  121.   x = $($$rand.99 + 1) - The function used is SAS's drand48() which 
  122.   generates the number using a linear congruential algorithm and 48bit 
  123.   arithmetic... (swear to God :)
  124.  
  125. - $$MEM.CHIP   - the remaining chip memory
  126. - $$MEM.FAST   - the remaining fast memory
  127. - $$MEM.ALL    - all the remaining memory
  128. - $$MEM.CLARGE - largest chip memory block (slow)
  129. - $$MEM.FLARGE - largest fast mem block (slow)
  130.  
  131. - $$G4C.TABS   - current tab size
  132. - $$G4C.GRID   - current grid size
  133.  
  134.   Attributes (ATTR & SETATTR) :
  135.  
  136. - LVFILTER Pattern
  137.   Will filter the files in a dir listview according to the 
  138.   pattern you give - examp - make a LV hide all the icons:
  139.   - SetAttr MyGui.gc/1 LVFILTER "~(#?.info)"
  140.   Must <LVDir refresh> for the change to actually take place.
  141.  
  142.   Improvements :
  143.  
  144. - MakeScreen will now also understand the size argument as :
  145.   Width/Height/Depth/ViewMode - viewmode is optional
  146.   > MakeScreen MyScreen 640/512/4/0x21004 'my screen'
  147.  
  148. - You can now give -10 as Top in a WinBig command and the window
  149.   will be positioned just under the screen title bar.
  150.  
  151. - New operator:  !! (double exclamation) means not equal, but unlike
  152.   the != operator, it's case insensitive - i.e. <if a !! A> is FALSE
  153.  
  154. - Made a big internal change in the way commands are recognized
  155.   and structured. As a result, Gui4Cli now parses files a little
  156.   faster (we're talking microseconds here.. if you can tell the
  157.   difference you're probably an alien). More importantly it allows 
  158.   me to add and manage commands easier.
  159.  
  160. - The second part of an internal variable will now be translated
  161.   if it's a variable - (eg: $$RAND.$x) - $x must be a simple 
  162.   variable - no paths, [], or var-in-var allowed.
  163.  
  164.  Changes to Guis :
  165.  
  166. - Changed the Gui4Cli.gc gui. The preferences now include sound
  167.   effects. Also, now they can be saved in file guis:Gui4Cli.prefs 
  168.   which is a file that Gui4Cli will look for the 1st time it starts
  169.   up and run it, if it finds it.
  170.  
  171.   Bugs & Fixes :
  172.  
  173. - Fixed nasty bug in Set Buffers NewSize.
  174.  
  175. - Some programs like DPaint and Scala ignored arexx messages sent
  176.   from Gui4Cli with the SendRexx command. That has now been fixed. 
  177.   They wanted the ln_Name field of the msg to be set to "REXX"
  178.  
  179. - Buffers for the SETWINTITLE and SETSCREENTITLE commands are
  180.   now allocated dynamically, so there no need anymore to ensure
  181.   that the string buffer you give is large enough to fit the
  182.   translated version of the string. You can now do :
  183.   > SetWinTitle mygui.gc '$$lv.dir'
  184.  
  185. - SetWinTitle will now recognise the #this keyword
  186.  
  187. - Changed tab handling in listviews. Before, tabs were expanded
  188.   when the file was loaded. This meant that tabs became spaces
  189.   if you thereafter saved the file again with LVSave. Now, the
  190.   file is loaded as is, and tab expansion is done in the Listview
  191.   hook, at rendering time. It's better this way..
  192.  
  193. - Changed the LVFormat Extension (used in the CedBar.gc gui)
  194.   to account for the above change.
  195.  
  196. - MakeScreen - background pics now have correct colors.
  197.  
  198. - SetColor will disregard colors which are out of range.
  199.  
  200. - Fixed WinOnMouse mouse position. It didn't account for different
  201.   screen positions.
  202.  
  203.